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Foreword 



id , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.311: Generic Integration Reference Point (IRP) management; Requirements 

32.312: Generic Integration Reference Point (IRP) management; Information Service (IS) 

32.313: Generic Integration Reference Point (IRP) management; Common Object Request Broker 

Architecture (CORBA) Solution Set (SS) 

32.3 17: "Generic Integration Reference Point (IRP) management; SOAP Solution Set (SS)" 

The Itf-N interface is built up by a number of IRPs and a related Name Convention, which realise the functional 
capabilities over this interface. The basic structure of the IRPs is defined in TS 32.101 [1] and TS 32.102 [2]. 

All IRPs support a set of generic features. Those features allow to retrieve IRP profile and IRP supported versions. 
The present document contains the specification of those generic features. 
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Scope 



The purpose of the present document is to define a common service supported by all IRPs such as AlarmlRP. 

The present document is the "Information Service" part. It defines, for the purpose of supporting the common service, 

the information observable and controllable by management system's client (i.e. IRPManager) via the Itf-N. 

It also specifies the semantics of and the interactions used to carry this information. 

With this common service supported by all IRPs, an IRPManager can retrieve the profile of operations and notifications 
supported by a given IRP name-contained by an IRP Agent. An IRPManager can also retrieve the IRPVersions 
supported by a given IRP. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.301: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Requirements". 

[4] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[5] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[6] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 

[7] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault Management; Part 2: Alarm 

Integration Reference Point (IRP): Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.101 [1], TS 32.102 [2], 
TS 32.301 [3] and the following apply: 

IRP: see TS 32.102 [2]. 

IRPAgent: see TS 32.102 [2]. 

IRPManager: see TS 32.102 [2]. 

IRP document version number string (or "IRPVersion"): see TS 32.31 1 [5]. 



ETSI 



3GPP TS 32.312 version 8.0.0 Release 8 



ETSI TS 132 312 V8.0.0 (2009-01) 



Itf-N: see TS 32.102 [2]. 



3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 



CM 

DN 

EM 

IOC 

IRP 

IS 

ITU-T 

NE 

NM 

NR 

NRM 

OMG 

SS 

UML 



Configuration Management 

Distinguished Name 

Element Manager 

Information Object Class 

Integration Reference Point 

Information Service 

International Telecommunication Union Telecommunication standardisation sector 

Network Element 

Network Manager 

Network Resource 

Network Resource Model 

Object Management Group 

Solution Set 

Unified Modelling Language (OMG) 



System Overview 



System Context 



The general definition of the System Context for the present IRP is found in TS 32.150 [6] clause 4.7. 
In addition, the set of related IRP(s) relevant to the present IRP is shown in the two diagrams below. 




Figure 4.1 : System Context A 
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Figure 4.2: System Context B 



5 Information Object Classes (lOCs) 

5.1 Information entities imported and local labels 



Label reference 


Local label 


3GPP TS 32.622 [4], information object class, GenericiRP 


GenericiRP 


3GPP TS 32.1 11-2 [7], notification, notifyNewAlarm 


notifyNewAlarm 


3GPP TS 32.1 1 1 -2 [7], notification, not if yChangedAlarm 


not if yChangedAlarm 


3GPP TS 32.1 1 1 -2 [7], notification, not if yClearedAlarm 


notifyClearedAlarm 


3GPP TS 32.1 1 1 -2 [7], notification, not if yAckStateChanged 


not if yAckStateChanged 



5.2 Class Diagram 

5.2.1 Attributes and relationships 

This clause depicts the set of IOCs that encapsulate information relevant for this service. This clause provides the 
overview of all IOCs in UML. Subsequent clauses provide more detailed specification of various aspects of these IOCs. 



«lnformationObjectClass» 
ManagedGenericIRP 



iRPVersions 

operationNameProfile 

operationParameterProfile 

notificationNameProfile 

notificationParameterProfile 
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5.2.2 Inheritance 

This clause depicts the inheritance relationships that exist between IOCs. 



«lnformationObjectClass» 
GenericIRP 

(from TS32.622) 



«lnformationObjectClass» 
ManagedGenericIRP 



5.3 



IOCs definition 



5.3.1 ManagedGenericIRP 



5.3.1.1 



Definition 



This information object represents a generic IRP which supports generic management capabilities. It inherits from IOC 

GenericIRP. 



5.3.1.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifier 


Write Qualifier 


iRPVersions 


- 


M 


- 


- 


operationNameProf ile 


- 


O 


- 


- 


operationParameterProf ile 


- 


O 


- 


- 


not if icationNameProf ile 


- 





- 


- 


not if icationParameterProf ile 


- 





- 


- 



5.3.1.3 



Notification 



Name 


Qualifier 


Notes 


notifyNewAlarm 


O 


See Alarm IRP (3GPP TS 32.1 11-2 [7] 


not i f yChangedAl arm 


O 


See Alarm IRP (3GPP TS 32.111-2 [7] 


notifyClearedAlarm 





See Alarm IRP (3GPP TS 32.111-2 [7] 


notifyComments 





See Alarm IRP (3GPP TS 32.1 11-2 [7] 


notifyAckStateChanged 





See Alarm IRP (3GPP TS 32.111-2 [7] 



5.4 Information relationships definition 

None 
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5.5 



Information attributes definition 



This clause defines the semantics of the attributes used in IOCs. 



5.5.1 Definitions and legal values 



Attribute Name 


Definition 


Legal Values 


iRPVersions 


This attribute contains a set of iRPVersions. The set 
contains at least one element. 


See definition "IRP 
document version 
number string" in 
clause 3.1. 


operationNameProf ile 


This attribute contains a set of elements. 
The n-th element of this set contains the set of operation 
names supported for the iRPVersion identified in the n- 
th element of iRPVersions attribute. 




not if i cat ionName Prof ile 


This attribute contains a set of elements. 
The n-th element of this set contains the set of notification 
names supported for the IRPVersion identified in the n- 
th element of iRPVersions attribute. 




operationParameter Prof ile 


This attribute contains a set of elements. 

The n-th element of this set contains the set of set of 

notification parameters supported by the operations 

identified in the n-th element of 

operationNameProf ile attribute. 

The set of operation parameters are placed in the set in 

the same order as the order followed by the operation 

names in their set. 




notif icationParameter Prof ile 


This attribute contains a set of elements. 

The n-th element of this set contains the set of set of 

notification parameters supported by the notifications 

identified in the n-th element of 

notif i cat ionName Prof ile attribute. 

The set of notification parameters are placed in the set in 

the same order as the order followed by the notification 

names in their set. 





6 Interface Definition 



6.1 Class diagram representing interfaces 



«lnformationObjectClass» 
ManagedGenericI RP 



«may 



realize» 



«lnterface» 
GenericlRPVersionOperations 



+ getlRPVersionQ 



V 

«lnterface» 
GenericlRPProfileOperations 



«opt» + getOperationProfile() 
«opt» + getNotificationProfileQ 
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6.2 



Generic rules 



• Rule 1: each operation with at least one input parameter supports a pre-condition valid_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each such 
operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition 
valid_input_parameter is false. The exception has the same entry and exit state. 

• Rule 2: Each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and the pre- 
condition indicates that the operation supports the named optional input parameter. Additionally, each such 
operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx which is raised when 
(a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the named optional input parameter 
is carrying information. The exception has the same entry and exit state. 

• Rule 3: each operation shall support a generic exception operation_failed_internal_problem which is raised when an 
internal problem occurs and that the operation cannot be completed. The exception has the same entry and exit state. 

6.3 genericlRPVersionOperations Interface (M) 

6.3.1 Operation get IRPVers ion (M) 



6.3.1.1 



Definition 



IRPManager wishes to find out the IRP SS versions supported by an IRP. The IRP shall respond with a set of supported 
IRP SS version(s). The list of returned IRP versions is such that the IRPManager can use any of these versions without 
having to specify an IRPVersion to the IRP Agent. 



6.3.1.2 

None 



Input parameters 



6.3.1.3 



Output parameters 



Matching Information 

ManagedGenericIRP . iRPVersions . 



Parameter Name 



Qualifier 



Comment 



versionNumberSet 



M 



It indicates one or more SS version numbers 
(IRPVersion, as defined by "IRP document 
version number string" in clause 3.1 ) supported 
by the IRP. 



status 



M 



ENUM (Operation succeeded, 
Operation failed) 



If operation_failed_internal_problem status ■ 
OperationFailed. 



6.3.1.4 

None specific 

6.3.1.5 

None specific 

6.3.1.6 

None specific 



Pre-condition 



Post-condition 



Exceptions 
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6.4 genericlRPProfileOperations Interface (O) 

6.4.1 Operation getOperationProf ile (O) 



6.4.1.1 



Definition 



IRPManager invokes this operation to query the detailed profile of an IRP (supported operations and supported 
parameters) for a specific supported version. The notification profile will provide details about notifications that are 
specifically defined by this IRP. 



6.4.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


iRPVersion 


M 


Element of ManagedGenericIRP . iRPVersions . 


It contains a version number. 



6.4.1 .3 Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


operationNameProf ile 


M 


Elements of 

ManagedGenericIRP . operationNameProf ile 
corresponding to the iRPVersion parameter. 


If this parameter contains no 
information, it implies that the 
IRP does not support any 
operation. 


operationParameter Prof ile 


M 


Elements of 

ManagedGenericIRP . operationParameterProf ile 
corresponding to the iRPVersion parameter. 




status 


M 


ENUM (Operation succeeded, Operation failed) 


If 

operation_failed_invalid_version 
status = OperationFailed. 



6.4.1.4 



Pre-condition 



validlRPVersion . 



Assertion Name 



Definition 



validlRPVersion 



The iRPVersion input parameter identifies a supported version contained in attribute iRPVersions 
of ManagedGenericIRP. 



6.4.1.5 Post-condition 

None specific 



6.4.1.6 



Exceptions 



Name 


Definition 


Operation failed invalid version 


Condition: validlRPVersion is false 

Returned Information: The output parameter status 

Exit state: Entry State 
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6.4.2 Operation getNotif icationProf ile (O) 



6.4.2.1 



Definition 



IRPManager invokes this operation to query the detailed notification profile of an IRP (supported notifications and 
supported parameters) for a specific supported version. The notification profile will provide details about notifications 
that are specifically defined by this IRP. For example, if this IRP is notification IRP R4, then 
getNotif icationProf ile will not return any information since no notification is defined in notification IRP R4. 



6.4.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


iRPVersion 


M 


Element of ManagedGenericIRP . iRPVersion 


It contains a version number. 



6.4.2.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


not if icationNamePro 

file 


M 


Element of 

ManagedGenericIRP . notif icationNameProf ile 
corresponding to the iRPVersion parameter. 


If this parameter contains no 
information, it implies that the IRP 
does not support any notification. 


not if icationParamet 
erProf ile 


M 


Element of 

ManagedGenericIRP . notif icationParameterProf ile 
corresponding to the iRPVersion parameter. 




status 


M 


ENUM (Operation succeeded, Operation failed) 


If operation_failed_invalid_version 
status = OperationFailed. 



6.4.2.4 



Pre-condition 



validlRPVersion . 



Assertion Name 



Definition 



validlRPVersion 



The iRPVersion input parameter identifies a supported version contained in attribute iRPVersions 
of ManagedGenericIRP. 



6.4.2.5 Post-condition 

None specific 

6.4.2.6 Exceptions 



Name 


Definition 


Operation failed invalid version 


Condition: validlRPVersion is false 

Returned Information: The output parameter status 

Exit state: Entry State 
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